home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / ASTRNOMY / STARPL20.ZIP / MAKEPLAN.DOC < prev    next >
Text File  |  1993-03-23  |  7KB  |  161 lines
  1.  
  2.                   MAKEPLAN V1.3 - a STARPLOT Utility.
  3.  
  4.  
  5.                             INTRODUCTION
  6.  
  7.  
  8. This program can make a STARPLOT compatible file containing Sun, Moon and 
  9. Planet positions for any year between 1890 and 2090.  It can also, given 
  10. the orbitel elements, create similar files with comet or minor planet 
  11. positions.
  12.  
  13. To start the program, in the directory containing the three files 
  14. MAKEPLAN.EXE, PLANETS.NDX and PLANETS.DAT simply type;
  15.  
  16. MAKEPLAN
  17.  
  18.  
  19. The rest of this document gives further details on MAKEPLAN.
  20.  
  21.                              
  22. On typing MAKEPLAN you will be presented with a copyright title screen, 
  23. press any key to get past this and you will see a menu screen with the
  24. choices of Sun, Moon and Planets, or Minor Planets or Comets.
  25.  
  26.  
  27.                         SUN, MOON and PLANETS
  28.  
  29. On choosing Sun, Moon and planets you will be presented with a setup screen 
  30. with default parameters.
  31.  
  32. Use the tab key to move about the parameters, context sensitive help will 
  33. be displayed as you do so.
  34.  
  35. The parameters are:
  36.  
  37. Year - this is the year over which the positions are calculated, you can 
  38. change it to any value between 1890 and 2090.
  39.  
  40. Filename - this is the file to which the results are saved.  It is a 
  41. STARPLOT compatible file, typically "PLAN1992.STR".  You can change the 
  42. name to any valid DOS filename.
  43.  
  44. Dates - for each of the planets, and for the sun and moon, there is a field 
  45. containing the days of the month on which the position of the body will be 
  46. calculated.  Pressing the space bar toggles these values to one of the 
  47. following possible sets of dates:
  48.  
  49. None                 - No positions for this body will be calculated.
  50. 1st and 15th         - The position of the body will be calculated for the
  51.                        first and the fifteenth day of each month.
  52. 1st,11th,21st
  53. 1st,8th,15th,23rd
  54. 1st,4th,7th,10th....
  55.  
  56. For example, if you set every body to "None" apart from mars, which you set 
  57. at "1st,8th,15th,23rd" you would end up with a file containing only 
  58. positions for mars.  48 positions would be calculated, four for each of the 
  59. twelve months of the year.  You could load it into STARPLOT, thus showing 
  60. all the 48 positions on the screen, which would trace out the planets path 
  61. for you, or you could use the "Planet File Merge" option to pick a single 
  62. position of mars out on any given day.
  63.  
  64. Even though the file only contains four positions a month, the Planet File 
  65. Merge can still find intermediate days, since it uses the positions it does 
  66. have to interpolate for those days not in the file.
  67.  
  68. This is a reason why for the faster moving bodies such as mercury and 
  69. especially the moon, you should choose to calculate more positions, whereas 
  70. for the slower bodies such as neptune and pluto, the "1st and 15th" will be 
  71. good enough since the motion being small, is easily interpolated for 
  72. intermediate days.
  73.  
  74. Having set the parameters, choose 'Execute Calculation' to begin the 
  75. calculation.  As the values are calculated they are put into the file and 
  76. are displayed on screen.  If you are calculating a lot of positions for all 
  77. the planets this could be a lengthy process, particularly if you have a 
  78. slow PC.  If this is the case then you might as well go have a cup of tea 
  79. and come back later.
  80.  
  81. When finished the program returns to the setup screen allowing you to 
  82. either return to the top menu or start another calculation.  If you do 
  83. another be sure to change the filename!
  84.  
  85.  
  86.  
  87.                            MINOR PLANETS
  88.  
  89. To successfully create the minor planets path you will need its orbitel 
  90. elements, these are published by astronomical clubs and institutions.  In 
  91. particular your library should have a copy of The Astronomical Almanac 
  92. which lists the elements for the larger minor planets.  The setup screen 
  93. allows you to input the elements, and also gives a brief description of 
  94. each element as you do so.
  95.  
  96. On choosing 'Execute Calculation' a STARPLOT compatible file will be 
  97. created, containing the positions calculated over a six month period on the 
  98. 1st, 4th, 7th, 10th, 13th, 16th, 19th, 22nd, 25th and 28th of each month. 
  99.  
  100. The magnitude parameters H and G for some of the minor planets are:
  101.  
  102.                         H        G
  103.  
  104. Ceres                   3.32     0.11
  105. Pallas                  4.13     0.15
  106. Juno                    5.31     0.30
  107. Vesta                   3.16     0.34
  108. Astraea                 6.91     0.25
  109.  
  110.  
  111.  
  112.                            COMETS
  113.  
  114. The comets set up screen and action is very similar to that of minor 
  115. planets.  The orbitel elements are slightly different to allow for the 
  116. possibility of a comets orbit being parabolic, whereas a minor planets 
  117. is always elliptical.  The magnitude parameters are also different.
  118.  
  119.  
  120.  
  121.  
  122.                           THE CALCULATION
  123.  
  124.  
  125.  
  126. The calculations follow the techniques given in the book "Astronomical 
  127. Algorithms" by Jean Meeus.  The software toolbox associated with the book 
  128. has been used, MAKEPLAN therefore includes routines written by J Sax, a 
  129. condition of using this software is the display of the copyright notice 
  130. which appears on using the program.
  131.  
  132. MAKEPLAN uses two data files, PLANETS.DAT and PLANETS.NDX which must be 
  133. present in the same directory.
  134.  
  135. Geocentric positions are calculated at the required intervals through the 
  136. year.  Then apparent positions are recalculated taking light time into 
  137. account.
  138.  
  139. Aberration and nutation effects are not included.  This is because the 
  140. resultant file is to be plotted on a star chart, and aberration/nutation 
  141. has the same effect on background stars as on the planets position.
  142.  
  143. Finally precession is taken into account, the coordinates are transformed 
  144. to the equinox of J2000.0, so the body can be plotted directly on a star 
  145. chart drawn to that epoch.
  146.  
  147. Magnitudes are also calculated.  The value 0.0 is given as the Suns 
  148. magnitude, which is just a default value of no meaning.
  149.  
  150. For the Moon, the value inserted here is the phase - between 1.0 and 0.0, 
  151. it is unfortunate this is labelled Magnitude in the STARPLOT program, but 
  152. otherwise the field would not be used at all, and it might as well hold 
  153. phase information rather than nothing.
  154.  
  155. MAKEPLAN can be freely used, copied and passed on.  If you haven't already 
  156. done so, please register your copy of STARPLOT.
  157.  
  158. If you find any bugs let me know!
  159.                                    - Bernard Czenkusz
  160.  
  161.